home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 004a / mtg20.zip / MTG.DOC < prev    next >
Text File  |  1991-04-06  |  95KB  |  2,150 lines

  1.     
  2.     
  3.     
  4.                            Making The Grade v2.0
  5.                            ~~~~~~~~~~~~~~~~~~~~~
  6.                              Copyright (c)1990
  7.                                     by
  8.                                 Rick Pedley
  9.                             Coffee Mug Software
  10.     
  11.     
  12.     Shareware Version Notes
  13.     ~~~~~~~~~~~~~~~~~~~~~~~
  14.          This is a shareware version of Making The Grade (hereafter
  15.     referred to as MTG).  The shareware version is designed to allow
  16.     you to try out the program for a period of time at no cost, be-
  17.     fore deciding whether or not to buy the commercial version. Both
  18.     versions are unprotected and can be easily backed up or copied 
  19.     to a hard disk.
  20.          If you decide that MTG meets your requirements and wish
  21.     to continue using it, you must then register the software by
  22.     sending in a completed order form (which can be printed from the
  23.     Main Menu) with a check or money order for $42 ($49 Cdn) plus $3
  24.     shipping & handling.  Shareware operates on the principles of
  25.     trust and honesty: you get to thoroughly test a completely
  26.     functional program before purchasing; the programmer can offer
  27.     his/her products at a lower price than similar commercial
  28.     products because of the highly efficient way in which shareware
  29.     is distributed.
  30.          You are encouraged to make as many copies as you like of
  31.     the shareware version of MTG - please give them to your friends.
  32.     If you purchase the commercial version of MTG, you may make as
  33.     many back-up copies for your own use as you wish.  However, it
  34.     is a violation of the copyright laws of Canada and the United
  35.     States to duplicate the commercial version of MTG for other than
  36.     the purchaser's personal use.  The shareware version contains
  37.     all the features of the commercial version, with the following
  38.     exceptions:
  39.     
  40.          o  normally, a user-defined password can be in-
  41.             stalled at the opening screen, giving some
  42.             measure of protection against unauthorized
  43.             access to your files.  This feature has been
  44.             disabled in the shareware version to enable
  45.             copies to be more easily passed along.
  46.     
  47.          o  the commercial version displays the owner's name
  48.             at the top of the title screen, instead of the
  49.             "This is a SHAREWARE version of..." line you see
  50.             there now.  Aside from discouraging people from
  51.             passing unauthorized copies around, this feature
  52.             serves a more useful purpose: your name will
  53.             automatically be inserted into any of the printed
  54.             reports that require a teacher's name.
  55.     
  56.          o  the commercial version includes a printed manual with
  57.             table of contents and index, and complete document-
  58.             ation, instead of the abbreviated 'doc' file you are
  59.             now reading.  READ THE END OF THIS FILE FOR RECENTLY
  60.             ADDED FEATURES (v1.1, 1.2, 1.3, 1.4, 1.5, 2.0).
  61.     
  62.                                     - 1 -
  63.     
  64.     
  65.     
  66.     
  67.          o  the commercial version may be ordered in 5 1/4"
  68.             360K format or in 3.5" 720K format. Receive a free
  69.             copy of Word Challenge with your order!
  70.  
  71.          To order the commercial version of MTG, select 'Print an
  72.     order form' from the Main Menu.  When completing the order form
  73.     be sure to print your full name in BLOCK LETTERS, since this is
  74.     the name that will appear on the title screen and on reports
  75.     (decide whether you wish to be officially known as Bill, Liz, or
  76.     William, Elizabeth, etc).  Please make payment by cheque or
  77.     money order (personal cheques accepted).  Packages are shipped
  78.     the day after orders are received.
  79.     
  80.                           OVERVIEW OF FEATURES
  81.                           ====================
  82.     
  83.          MTG provides a complete system for recording and processing
  84.     student grades.  The program can accommodate up to forty stud-
  85.     ents and an unlimited number of test scores per class.  As well,
  86.     as many as fifteen students can be moved 'offline', their aca-
  87.     demic records preserved for future use.  Scores are entered on a
  88.     customized spreadsheet-like screen, and the many built-in
  89.     prompts and safeguards help to ensure straightforward, error-
  90.     free record keeping.  Percentages and weighted averages are
  91.     calculated automatically as data is entered, so that at any
  92.     given moment, all values shown are up-to-date.  As many as 18
  93.     'letter grades' can be assigned.  MTG distinguishes between a
  94.     score of zero, and a 'no score', allowing you to include or
  95.     ignore missing scores when calculating test averages, student
  96.     averages, and final grades.
  97.     
  98.          Apart from data related purely to grades, MTG records due
  99.     dates for assignments, names and descriptions for each
  100.     assignment, course descriptions, and provides two categories in
  101.     which to record student-specific information such as student
  102.     identification numbers, telephone numbers, homeroom numbers --
  103.     it's entirely up to the teacher.  MTG can also track absentee-
  104.     ism, truancy, and times late.
  105.     
  106.          Any item -- a student, a test, or the entire data set --
  107.     can be graphed.  Simply move the cursor onto the item you wish
  108.     to graph, and press the appropriate command key.  Any graph (in
  109.     fact, any screen) can be printed.  'Cumulative average'
  110.     histograms (bar graphs) show a student's progress compared to
  111.     his/her classmates over a period of time.  'Frequency distri-
  112.     bution' histograms indicate how test scores are distributed.
  113.     Standard deviation, median, average, range, percentage failing
  114.     are displayed on the graph.  The standard deviation and average
  115.     can be temporarily changed, resulting in a new distribution of
  116.     scores.  A temporary set of new raw scores is also shown for
  117.     comparison.
  118.     
  119.          Nine reports are available and can be printed in draft or
  120.     'near letter quality' mode.  Report types include a progress
  121.     report, a gradebook-style printout, blank seating plan, blank
  122.     attendance record, attendance report, class summary, student
  123.     information report, missing assignments report, and blank mark
  124.     sheet.  Most reports have a variety of customizing options, such
  125.     
  126.     
  127.                                   - 2 -
  128.     
  129.     
  130.     
  131.     as date format, titles, leaving some data categories blank, the
  132.     number of copies to be printed, etc.  The user interface is easy
  133.     to learn, and Help screens are available for each of the main
  134.     program segments: Edit, Graph, and Report.
  135.     
  136.     
  137.                          HARDWARE REQUIREMENTS
  138.                          =====================
  139.     
  140.          The minimum requirements to run MTG are as follows: a PC-
  141.     compatible with 512K of RAM, CGA video, a single 5 1/4" or 3.5"
  142.     drive, and a printer.  A color monitor is preferable but not
  143.     essential.  MTG works great with EGA and VGA video, but will not 
  144.     work with Hercules, Olivetti, and MPDA adapters (the program 
  145.     makes use of four separate video 'pages', which are not present 
  146.     in these adapters). MS-DOS or PC-DOS 3.0 is the minimum version 
  147.     of DOS supported.
  148.     
  149.     
  150.     
  151.     
  152.     
  153.                               GETTING STARTED
  154.                               ===============
  155.     
  156.          The first thing you should do is make at least one copy of
  157.     the program disk, and then put the original away in a safe
  158.     place.  Always use a copy, never the original.  If you want to
  159.     run MTG from a hard disk, create a new subdirectory (\MTG for
  160.     example) and copy all files on the floppy into this subdir-
  161.     ectory.  You may then want to create another subdirectory inside
  162.     \MTG for storing data files, \MTG\GRADES for example.  If you
  163.     aren't using a hard disk, you should now format a floppy disk on
  164.     which to store your data files.  A 360K floppy disk can com-
  165.     fortably store ten full data files.  If you are the adventurous
  166.     sort, and you have a list of students handy, and perhaps a set
  167.     of scores that you would like to enter, proceed with the next
  168.     section, Quick Start.  Otherwise, jump ahead to the Tutorial,
  169.     which uses the sample data file that has been provided,CHE-3A1!.
  170.     
  171.                      ____________________________
  172.     
  173.     
  174.                               QUICK START
  175.                               ===========
  176.     
  177.          Boot DOS with your system disk, and type MTG at the prompt
  178.     to run Making The Grade.  Be sure to 'log on' to the drive and
  179.     prefix from which you are running MTG.  For example, if you are
  180.     currently logged onto drive B:, don't put the program disk in
  181.     drive A: and type A:MTG.  This will seem to work at first, until
  182.     MTG goes looking for support files and is unable to find them.
  183.     Instead, log onto A: first by typing A: (press RETURN).  Then
  184.     run MTG.  If you are running MTG from a subdirectory (on a hard
  185.     disk), be sure to add the subdirectory name to the prefix.
  186.          From the Main Menu screen, select 'Change the setup' by
  187.     
  188.     
  189.                                   - 3 -
  190.     
  191.     
  192.     
  193.     pressing the appropriate number, or using the arrow keys and
  194.     RETURN.  From the Change Setup menu, choose the printer you wish
  195.     to use, and whether your printer needs an extra linefeed or not
  196.     (say No for now).  You should also check the letter grade format
  197.     to see if it matches the format used by your school; change it
  198.     if necessary.  Two data categories are provided to store
  199.     information on each student.  By default, these are homeroom
  200.     number and student number, but they can be changed if you wish.
  201.     You can also specify where MTG should look for your data files
  202.     each time you run the program.  This pathname is stored in the
  203.     setup file, and is displayed at the top of the Main Menu screen.
  204.     The password feature has been disabled in the shareware version,
  205.     but normally you can either install a password or disable the
  206.     feature altogether.  When you have finished changing the setup,
  207.     exit to the Main Menu.
  208.          Once you have selected the drive and pathname where your
  209.     files are to be stored (displayed at the top of the screen),
  210.     you're ready to start a new class.  Select 'Start a new class'
  211.     from Main Menu.  This brings up the following:
  212.     
  213.                    1.  Start from scratch
  214.                    2.  Duplicate an existing roster
  215.     
  216.          'Duplicate an existing roster' is handy if you teach the
  217.     same (or nearly the same) students more than one subject.  From
  218.     here, you can select an already existing file.  MTG will use the
  219.     list of students from this file, all student information, and
  220.     such things as the name of the school, and discard all test
  221.     data.  Students can then be added to or deleted from this
  222.     duplicated roster, and a new class (file) is created.  The old
  223.     file remains completely unchanged.  This is also how you can
  224.     continue another file with more than 40 sets of scores in it;
  225.     see 'More Than 40 Sets of Scores?' for more information.
  226.          To begin a completely new class, select 'Start from
  227.     scratch'.  This takes you directly to the Administrative Details
  228.     screen.
  229.     
  230.     
  231.     Administrative Details
  232.     ~~~~~~~~~~~~~~~~~~~~~~
  233.          Fill in each of the four categories.  The course code
  234.     serves as the file name.  Note the restriction of eight char-
  235.     acters; a list of legal DOS filename characters appears to the
  236.     right.  Once a course name has been entered, MTG checks to see
  237.     if a file with the same name already exists and warns you of the
  238.     possibility of over-writing the old file.  All of this inform-
  239.     ation will appear later in printed reports, so enter it accu-
  240.     rately and make appropriate use of upper and lower case letters.
  241.     When you've completed all the information, proceed to the Edit
  242.     screens.
  243.     
  244.     
  245.     Using Edit
  246.     ~~~~~~~~~~
  247.          There are two kinds of Edit screens: Student screens and
  248.     Test screens.  A Student screen shows one student's name at the
  249.     
  250.     
  251.                                   - 4 -
  252.     
  253.     
  254.     
  255.     top, along with homeroom, student number, letter grade, and
  256.     average (SAvg).  Below are listed all the tests he has written
  257.     ('test' is used generically throughout to indicate any assign-
  258.     ment, essay, lab, quiz, etc.).  A Test screen shows one test
  259.     name at the top with the maximum score (what the test is out
  260.     of), a description, date due/marked/assigned, weight, and test
  261.     average (TAvg).  You can work on either type of screen.  To
  262.     switch to the other screen, position the cursor on the item
  263.     (test or student) you wish to zoom on, and press Alt-Z.  That
  264.     item now appears at the top, with all the relevant information
  265.     below.
  266.          The other way to view data is to page through successive
  267.     Student or Test screens by pressing Pg Dn or Pg Up (or F9 and
  268.     F10).  Currently there is no data in the file, so there isn't
  269.     much to see.  Load the sample file to better see the effect of
  270.     'zooming' and 'paging'.
  271.     
  272.          You should decide at this point whether the new file
  273.     represents one term/semester, or a whole year.  Most teachers
  274.     surveyed indicated that 40 assignments would be more than
  275.     sufficient for a whole year, but in cases where students are
  276.     continually evaluated (perhaps three times or more a week), two
  277.     or more files may be necessary.  See the section entitled 'More
  278.     Than 40 Sets of Scores?' to find out how MTG accommodates as
  279.     many as 1000 tests/assignments.  It is recommended that the
  280.     primary school teacher start a new file for each subject; use
  281.     'Duplicate a Roster' to avoid re-typing the names.
  282.     
  283.         If you decide to record a whole year's marks in one file,
  284.     determine roughly how the weights for each term or semester
  285.     should be split (you can always change them later).  After you
  286.     have decided to assign 50% of the weight to the first semester,
  287.     for example, then you can begin to weight each test accordingly.
  288.     Many teachers are uncomfortable with weighting assignments
  289.     versus using a total marks scheme, mostly because of the extra
  290.     arithmetic involved.  With MTG, the weighting system is easy to
  291.     use and offers significant advantages over the other method.
  292.         In general, keep the weight for each assignment small, say
  293.     2% to 4%, with larger weights reserved for more important
  294.     assignments.  The total weight cannot be more than 100%, but
  295.     more importantly, never needs to TOTAL 100% at the end of the
  296.     year.  What matters is the RELATIVE weight of one assignment to
  297.     another, not the total weight.  If the final exam is assigned a
  298.     weight of 40%, that leaves up to 60% for the rest of the
  299.     semester.  A weight can be as small as 0.1% (one decimal place
  300.     is allowed).  Actually, a weight can be zero, effectively
  301.     removing the test from any calculations.  Weights can be changed
  302.     at any time, even after all the scores have been entered.
  303.     Everything else is immediately recalculated to reflect the
  304.     change.  If you run out of room (i.e. you reach 100% before the
  305.     end of semester), divide each weight in two.  Since it's the
  306.     relative weight that counts, not the total, no harm is done.
  307.     
  308.          Press Alt-Z until you are looking at a Test screen.  Using
  309.     the arrow keys (or press Home or F7), move the cursor to the top
  310.     of the screen just to the right of 'Test:' and enter a test
  311.     name.  You can enter information in two ways:
  312.     
  313.     
  314.                                 - 5 -
  315.     
  316.     
  317.     
  318.     1. Simply begin typing.  A row of dots appears, indicating how
  319.     much room there is.  To back up and correct something, use the
  320.     backspace key;  to  start  over,  press  ESC.   To  exit  the
  321.     cell and restore whatever was there before, press ESC once more.
  322.     To finish editing a cell, press RETURN.  Depending on how fast
  323.     your computer is, there may be a slight pause as some calcul-
  324.     ations take place.
  325.     
  326.     2. If you aren't sure what goes in a particular cell or column,
  327.     press the space bar.  Whenever the first character typed is a
  328.     space, this signals to MTG that you want an 'edit box'.  An edit
  329.     box is a small window that opens on the screen with a line for
  330.     data input, but more importantly, with a brief description of
  331.     the type of information you are expected to enter.  Enter data
  332.     in the same way as in method 1.  Pressing the space bar when the
  333.     cursor is on the class name takes you to the Administrative
  334.     Details screen.
  335.     
  336.          A test name can be any six-character name you want; in MTG
  337.     you are not restricted to pre-set categories.  I suggest some
  338.     sort of naming system though -- something like Lab 1, Lab 2,
  339.     Test 1, Quiz 1, etc., just so there is consistency, but it's
  340.     totally up to you; MTG doesn't care what you call them.  The
  341.     large blank space to the right of the test name is for a test
  342.     description.  Enter a description of what material the test
  343.     covers, or what kind of assignment it is.  Try not to leave
  344.     these cells blank; they will be very useful later on.
  345.     
  346.          Move to the second row and enter a weight (the edit box
  347.     will tell you how big the weight can be, based on the current
  348.     total weight), a maximum score (must be a whole number), and a
  349.     date (the edit box will bring up today's date, or you can enter
  350.     something else). ** NEW ** You may now use the `total marks'
  351.     format instead of weights.  See Addendum 2.0 at end of this doc.
  352.          Next, move down to the third row, in the upper left corner
  353.     (press the space bar here, to be sure you're in the student name
  354.     column).  You're now ready to begin entering the list of stud-
  355.     ents.  The preferred format for names is: Smith, John L.  What-
  356.     ever format you use, try to be consistent throughout.  These
  357.     names will later be printed on reports, so neatness is import-
  358.     ant.  Don't worry about the order in which you enter the names.
  359.     The program can sort them for you later.  Move down the left
  360.     side, and if there are more than twenty names, continue in the
  361.     upper left corner on the other side.  After you enter all the
  362.     names, you may also want to enter the homeroom numbers and
  363.     student numbers if you have the data handy.  When you're all
  364.     done, press Alt-A (for Arrange) and select '1. Student name' to
  365.     sort the names alphabetically.  While you're doing this, note
  366.     the other options for sorting.  The last option inverts the list
  367.     after you have done one of the other sorts.
  368.     
  369.          This is a good time to save the file.  Make sure your data
  370.     disk is in the drive and press Alt-S.  Save your work period-
  371.     ically during a session to avoid suddenly losing a lot of work
  372.     if the power goes off.
  373.     
  374.          Almost all commands in MTG are selected from menus or by
  375.     pressing the Alt key in combination with something else.  Press
  376.     
  377.     
  378.                                  - 6 -
  379.     
  380.     
  381.     
  382.     Alt-H (or F1) to look at a help screen for Edit.  I suggest
  383.     printing both help screens for reference.  At some point, you
  384.     should try all the commands listed to become familiar with them.
  385.     There are equivalent help screens for Graph and Report.  Notice
  386.     the use of Home, End, Pg Up, Pg Dn, and their function key
  387.     equivalents.  The function key equivalents allow you to have Num
  388.     Lock on so you can enter data with the numeric keypad, and still
  389.     be able to zoom and page (this system works only with keyboards
  390.     that have a second set of cursor keys).
  391.     
  392.     
  393.          Now you're ready to enter some scores.  Move to any cell
  394.     directly below the maximum score, and enter the 'raw score'
  395.     (abbreviated as 'RawS' on the Student screen).  A raw score can
  396.     be zero, no score (enter an '*'), or any number up to nine times
  397.     as large as the maximum, to one decimal place.  It is much more
  398.     useful to enter a 'no score' instead of a zero, and as you have
  399.     noticed, this is the default value when a new test is entered.
  400.     The usefulness will be apparent later on, and remember it is a
  401.     simple matter to change it to a zero at the end of the semester.
  402.     In the mean time, the student's average is calculated based only
  403.     on tests for which there are scores.  In other words, 'no
  404.     scores' don't count as zeros 'til you say so.
  405.     
  406.          As a raw score is entered, the percentage appears immed-
  407.     iately to the right (rounded up to the nearest whole number),
  408.     and in the next column, the student's over-all average.  In the
  409.     second row at the top, the test average (TAvg) is constantly
  410.     updated as new scores are entered.  When all scores have been
  411.     entered, press Alt-S again to save the file.
  412.     
  413.     
  414.     Printing a report
  415.     ~~~~~~~~~~~~~~~~~
  416.          It's a good idea to print a gradebook report after each
  417.     test.  The gradebook report serves two purposes.  You can print
  418.     the data for every test given so far.  This report contains
  419.     every piece of data necessary to reconstruct a file in the
  420.     unlikely event the file is damaged and becomes unreadable.  It
  421.     is your 'hard copy' backup of irreplaceable data.  The second
  422.     function of the gradebook report is to print the results of a
  423.     single test or range of tests, so that they may be posted on a
  424.     classroom bulletin board.   This report gives each student his
  425.     result on this test, the test average, so he can see how the
  426.     rest of the class did, his current over-all average, and the
  427.     class over-all average (the underlined figure in the lower right
  428.     hand corner).
  429.          Press Alt-R to go to the Report menu and print a gradebook
  430.     report.  Notice that you are asked if you want to print names or
  431.     student numbers on this report.  Numbers are handy if you intend
  432.     to post the results; they preserve anonymity.  On the student
  433.     screen in Edit, one of the data categories is labelled 'SN' for
  434.     'student number'.  MTG looks for this category, and if you
  435.     haven't changed it to something else, asks you this question
  436.     whenever you print a gradebook report or a missing assignment
  437.     report.  Either assign a small number to each student (from 1 to
  438.     however many students there are) or use something like the
  439.     school's identification number for each student.  Tip: sort the
  440.     
  441.     
  442.                                    - 7 -
  443.     
  444.     
  445.     
  446.     class a different way each time before you print the report (by
  447.     homeroom, inverted alphabetical order, etc.) to help prevent
  448.     students from figuring out who's who on the list.  Note: if your
  449.     report is double-spaced or prints all on one line (great for
  450.     conserving paper), you need to return to the Change Setup menu
  451.     and either add or remove the extra linefeed.
  452.     
  453.          The last step in a data entry session is to make a copy of
  454.     your data disk.  A good system is to keep one disk at home and
  455.     one at school.  Of course, the gradebook report is your third,
  456.     hard copy record.
  457.     
  458.          To learn more about Edit, Graph, and Report, the best thing
  459.     to do is exit to the Main Menu and load the sample file:
  460.     CHE-3A1!.  This file contains four complete sets of scores, and
  461.     better demonstrates the various functions than a file with only
  462.     one set of scores.
  463.     
  464.                          ______________________
  465.     
  466.     
  467.     
  468.                                TUTORIAL
  469.                                ========
  470.     
  471.     
  472.     Main Menu
  473.     ~~~~~~~~~
  474.          Main Menu is the 'control center' of MTG.  The diagram
  475.     below shows how the various program modules are linked, and the
  476.     possible directions in which you can move from one module to
  477.     another.
  478.     
  479.        Title Screen -----.     .------------- Graph -----.
  480.                           \    |                ^        |
  481.                            \   |                |        |
  482.                             \  |                |        |
  483.                              v v                v        |
  484.             CHANGE <-------> MAIN <----------> Edit      |
  485.             SETUP            MENU               ^        |
  486.                                ^                |        |
  487.                                |                |        |
  488.                                |                v        |
  489.                                '------------- Report <---'
  490.     
  491.     
  492.          From Main Menu the following selections can be made (the
  493.     shareware version varies slightly):
  494.     
  495.                    1.  Select data pathname
  496.                    2.  Edit a class
  497.                    3.  Start a new class
  498.                    4.  Select a new data drive
  499.                    5.  Change program setup
  500.                    6.  Temporarily exit to DOS
  501.                    7.  Delete a class
  502.                    8.  Quit Making The Grade
  503.     
  504.     
  505.                                   - 8 -
  506.     
  507.     
  508.     
  509.     
  510.          Press a number key for immediate action or move up and down
  511.     with the arrow keys to highlight a new selection and then press
  512.     RETURN.  All menus in MTG work in this fashion.
  513.     
  514.     
  515.     Changing Program Setup
  516.     ~~~~~~~~~~~~~~~~~~~~~~
  517.          If this is the first time you have used MTG, there are a
  518.     number of user-definable items to install, so select 'Change
  519.     program setup'.  From the Change Setup menu you can change or do
  520.     the following:
  521.     
  522.                    1.  Password
  523.                    2.  Standard data disk location
  524.                    3.  Printer setup
  525.                    4.  Letter grade format
  526.                    5.  Optional categories
  527.                    6.  Temporarily exit to DOS
  528.                    7.  Return to the Main Menu
  529.     
  530.     Select 'Standard data disk location'; MTG finds and lists all
  531.     disk drives by letter (hopefully, you're familiar enough with
  532.     your system to know which drive is represented by each letter).
  533.     Decide where you want your data disk to be and select the drive.
  534.     If you are using a hard disk, likely you will want to store data
  535.     files in a subdirectory.  By specifying a subdirectory, MTG will
  536.     know, every time you run the program, where your files are
  537.     stored.
  538.     
  539.     
  540.     Printer Setup
  541.     ~~~~~~~~~~~~~
  542.          Select 'Printer setup' from the Change Setup menu.  The
  543.     currently installed printer is highlighted.  When you run MTG
  544.     for the first time, a default setup file is created, and the
  545.     default printer is the Epson FX-85.  If you have a different
  546.     printer, look for it on the list.  If your printer is not on the
  547.     list, try an Epson or one of the two 'Alternate' printers.  MTG
  548.     assumes you have a printer connected to 'LPT1:', a parallel
  549.     port.  If you're not certain, chances are that is where your
  550.     printer is connected.   Note: The Roland Raven PR-2417 is
  551.     electrically and mechanically identical to the Panasonic
  552.     KX-P1124.
  553.     
  554.          The next paragraph tells you that your printer currently
  555.     sends an extra line feed after a carriage return, or does not,
  556.     and then asks which you would like.  Select 'No' for now -- you
  557.     can always change it later if your printouts are double-spaced,
  558.     or if everything prints on one line.
  559.     
  560.     
  561.     Letter Grades
  562.     ~~~~~~~~~~~~~
  563.          Next, from the Change Setup menu, select 'Letter grade
  564.     format'.  MTG lets you define a 'passing percentage' between 0
  565.     and 100%.  You can also define as many as 18 letter grades.  If
  566.     you are satisfied with the default settings, press 'N'.  To
  567.     make changes, press RETURN.
  568.     
  569.     
  570.                                   - 9 -
  571.     
  572.     
  573.     
  574.     
  575.          First, enter a passing percentage (this must be a whole
  576.     number between 0 and 100).  Then, you are asked for a one- or
  577.     two-character symbol for the highest letter grade.  Any visible
  578.     characters except spaces may be used.  Use the backspace key to
  579.     back up, ESC to start over, and RETURN to advance a line.
  580.     
  581.          Enter the lower boundary represented by the letter grade;
  582.     then press RETURN.  The next line appears, and the process
  583.     continues, until you enter a zero for the lower boundary, or
  584.     until you have used up the 18 letter grade categories.
  585.     
  586.          When you're done, MTG displays the new letter grade scheme
  587.     and passing percentage, and again asks if you want to change it.
  588.     Answer NO to finish and return to the Change Setup menu.
  589.     
  590.     TIP:  If you don't use letter grades at all, do this:
  591.     ~~~   enter a 'neutral' character in the first interval
  592.           (a '-', or '*' for instance) and then type a zero
  593.           as the lower boundary of the first interval.
  594.     
  595.     
  596.     Optional Categories
  597.     ~~~~~~~~~~~~~~~~~~~
  598.          From Change Setup, select 'Optional categories'.  Two
  599.     categories (fields, if you like) are provided to store
  600.     miscellaneous information pertaining to each student.  The
  601.     default definitions are student number and homeroom, but these
  602.     can be changed to anything you like.  Each definition consists
  603.     of two parts: a three character acronym or abbreviation, which
  604.     appears on the Edit screen, and a twelve character description,
  605.     which serves as a prompt in an edit box, and also shows up on
  606.     some of the printed reports.  Twelve characters in each category
  607.     are provided for the information itself.
  608.     
  609.     
  610.     Installing a Password
  611.     ~~~~~~~~~~~~~~~~~~~~~
  612.          Passwords offer simple protection against unauthorized
  613.     tampering.  If a password has been installed previously, you
  614.     will first be asked to enter the old password, before being
  615.     permitted to enter a new one.  A password can be any combination
  616.     of 6 to 20 visible characters.  Lower case letters are
  617.     automatically converted to upper case.  After entering the new
  618.     password, MTG will write it to the program disk.  The password
  619.     is stored directly into the program file MTG.EXE.  This is
  620.     another good reason to use only a copy of the original disk.
  621.     
  622.     Return to Main Menu
  623.     ~~~~~~~~~~~~~~~~~~~
  624.          If any change to the setup has been made, MTG now saves the
  625.     new setup to the program disk.  These changes are now in effect
  626.     each time you run the program.
  627.     
  628.     
  629.     Editing a Class
  630.     ~~~~~~~~~~~~~~~
  631.          From the Main Menu, choose 'Select data pathname'.  When
  632.     the files are listed, you should see the volume name /MTG at the
  633.     
  634.     
  635.                                   - 10 -
  636.     
  637.     
  638.     
  639.     top, and the data file CHE.3A1! listed below.  The menu in the
  640.     lower right corner lists your options at this point.
  641.     
  642.     IMPORTANT: Notice also, that the amount of free memory on your
  643.     ~~~~~~~~~  data disk is displayed.  When there is less than 29K
  644.                of space left on the disk, MTG will warn you by
  645.                flashing the amount of free space and beeping.  At
  646.                this point, you should exit to DOS, format a fresh
  647.                data disk, and copy some files over to the new disk.
  648.     
  649.                If you elect to ignore the warning, and keep adding
  650.                more data to the disk, you may at some point enter a
  651.                new set of scores, and then be unable to save the
  652.                file to disk.  Play it safe!
  653.     
  654.          From the menu, choose 'Accept the pathname above'.  From
  655.     Main Menu, select 'Edit a class', and then 'Select a class to
  656.     edit'.  The cursor jumps to the top of the list of files (as
  657.     many as 90 files may be listed here).  Press RETURN on the file
  658.     CHE-3A1!.
  659.     
  660.     
  661.     The TEST Screen
  662.     ~~~~~~~~~~~~~~~
  663.          In MTG, all assignments, essays, labs, homework
  664.     assignments, quizzes, exams, etc. are referred to as 'tests'.
  665.     Look at the top line on the screen, and you'll see the name of
  666.     the class displayed, the name of the test (TEST:Quiz.1), and a
  667.     description of the test (TOPIC: Matter).  Each test is given a
  668.     name up to 6 characters long, and a description up to 43
  669.     characters long.  This particular file uses a simple numbering
  670.     scheme for tests, e.g. Lab.1, Lab.2, Quiz.1, but you may label
  671.     tests any way that makes sense to you.  The description may also
  672.     contain information about the structure of the test, for
  673.     example: '2000 words on My Summer Vacation', or '20 multiple
  674.     choice on Plant Structure'.
  675.     
  676.          On the next line, the weight for this test is shown
  677.     (Wgt:3%).  All tests are given a weight between 0% and 100%, and
  678.     can be as small as 0.1%.  If you are not familiar with weighted
  679.     scores, don't panic; weighting with MTG is very simple to
  680.     implement, and above all, is flexible.  In other words, if the
  681.     weight you entered for a test three weeks ago turns out be
  682.     higher or lower than you want, it can easily be changed to
  683.     something else, with no extra work on your part.
  684.     *NEW* You can now use total marks. See Addendum 2.0 at the end.
  685.          The Test Average (TAvg:87%) shows the class average, as a
  686.     percentage, on this test.  This average is displayed and updated
  687.     even as you enter the test scores, so that at any point during
  688.     data entry, you know exactly how the class is doing.
  689.     
  690.          The next figure on the second line tells you what maximum
  691.     the test is scored out of, in this case 25; this number
  692.     represents the actual number of marks, not a percentage.  The
  693.     column of numbers below the Maximum shows the 'raw score'
  694.     obtained by each student on the test.  For example, Paul
  695.     Ackerman scored 22 out of 25 on Quiz.1.
  696.     
  697.     
  698.                                 - 11 -
  699.     
  700.     
  701.     
  702.          The next heading (Per) shows the percentage calculated by
  703.     dividing the raw score by the maximum, and multiplying by 100.
  704.     As you can see, Ackerman's 22/25 results in a percentage of 88%.
  705.     Percentages are calculated automatically as you enter the raw
  706.     scores.
  707.     
  708.          The last column, to the right of the percentage figures,
  709.     shows each student's overall average under the heading 'SAvg'.
  710.     This figure is also immediately updated as a new score is
  711.     entered, meaning you always know a student's average -- no
  712.     guessing.  NOTE: the total weight need not be 100% to give
  713.     accurate student averages; more on this later.
  714.     
  715.          'TDate' can be the date a test is due, the date you marked
  716.     it, or the date it was assigned.  The date may be entered any
  717.     way you wish: 88/09/10, Sept 10, etc.
  718.     
  719.          MTG handles a maximum of 40 students, and they can all be
  720.     displayed on this screen.  22 spaces are allowed for each name.
  721.     The names in this file are entered in 'last name, comma, space,
  722.     first name' format, but you can enter anything here.  When first
  723.     entering the names, it is not necessary to put them in any
  724.     particular order; MTG can sort them for you later, if you wish.
  725.     (MTG also prevents you from entering the same name twice - use
  726.     an initial to distinguish between the two Ernest Pringle's).
  727.     Note: 15 students can also be stored 'offline' in addition to
  728.     the 40 that are 'online'.
  729.     
  730.     
  731.     The STUDENT Screen
  732.     ~~~~~~~~~~~~~~~~~~
  733.          You may be wondering: 'Where are the other tests?'.
  734.     Earlier, MTG was referred to as a 'modified spreadsheet'.
  735.     Rather than scrolling across and down a cumbersome 40 x 40
  736.     spreadsheet, MTG organizes all its data into TEST screens and
  737.     STUDENT screens.  A TEST screen, as you have seen, displays the
  738.     pertinent information for one test, and the scores obtained by
  739.     all students on that test.  The procedure for handling more
  740.     than 40 sets of scores is discussed later on.
  741.     
  742.          Using the four arrow keys, move the cursor around the
  743.     screen until you have highlighted 'Watson, Kimberley' (actually,
  744.     the cursor can be on the student's name, raw score, percentage,
  745.     or average).  Then press Alt-Z.
  746.     
  747.     
  748.     
  749.     
  750.          When you press Alt-Z, MTG 'zooms' to the test or student
  751.     positioned under the cursor.  The TEST screen you were looking
  752.     at is replaced by a STUDENT screen.  The name: Watson, Kimberley
  753.     now is displayed at the top of the screen, along with other
  754.     information about that student, and all tests are listed below.
  755.          To the right of the student's name on the first line, are
  756.     the two 'optional categories', in this case set to the defaults:
  757.     Homeroom and Student Number.  On the second line is the
  758.     student's overall average (SAvg:90%), and his/her letter grade
  759.     (LG:A).
  760.     
  761.                                 - 12 -
  762.     
  763.     
  764.     
  765.          The heading 'Max' tops the column of maximum scores for all
  766.     tests.  'RawS' heads the column of raw scores on all tests for
  767.     Kimberley Watson.  To the right is the percentage each raw score
  768.     represents.  Further to the right is the weight (Wgt%) assigned
  769.     to each test, as a percentage.  The last column (TAvg) shows
  770.     shows how the class performed on each test, also given as a
  771.     percentage.  Looking at the 'Per' column and the 'TAvg' column,
  772.     you can compare a student's results on any test with the rest of
  773.     the class.  Finally, the heading 'TotWgt' indicates the total of
  774.     all weights assigned so far, which cannot exceed 100%.
  775.          After you've zoomed around a few times, press the  Pg Dn
  776.     and Pg Up keys (or F9 and F10).  This has the effect of moving
  777.     you to the next test or student, depending on whether you're on
  778.     a TEST screen, or a STUDENT screen.  By paging repeatedly, you
  779.     will move past the last test (or student), back to the top of
  780.     the list.
  781.     
  782.     
  783.     
  784.     
  785.     
  786.     
  787.     
  788.     HELP Screens
  789.     ~~~~~~~~~~~~
  790.          Each of the three modules: Edit, Graph, and Report has one
  791.     or more HELP screens, which give you a summary of all commands.
  792.     To look at a HELP screen, press Alt-H or F1.  To print a HELP
  793.     screen, press Shift-* (Prt Sc).  To print the vertical and
  794.     horizontal lines, your printer must be in IBM mode.
  795.     
  796.     
  797.          To practice entering data before starting your own file,
  798.     work through the following exercise.  The changes you make will
  799.     have no effect on the original sample file stored on disk unless
  800.     you save the file.
  801.     
  802.     A New Student
  803.     ~~~~~~~~~~~~~
  804.     1.   Let's add a new student to the list.  Move the cursor to
  805.          the blank line below Zebedee.  A blank line is always
  806.          reserved here for a new student, until all 40 spaces have
  807.          been filled.  Enter the name: Cruthers, Sandy (or your own
  808.          name, if you like).
  809.     
  810.     
  811.     
  812.     
  813.     
  814.     
  815.     2.   Now press Alt-A (for 'arrange'), and select: Arrange by
  816.          Student Name.  MTG will sort all names alphabetically,
  817.          which is one good reason to enter the names in 'Last,
  818.          First' order.  A lower case 'a' sorts ahead of an upper
  819.          case 'A', so be sure to capitalize where necessary.
  820.          You can also sort by Student Average, Total Absences,
  821.          Unauthorized Absences (all highest to lowest), by
  822.     
  823.     
  824.                                  - 13 -
  825.     
  826.     
  827.     
  828.          Homeroom, Student Number (sorted alphabetically), Times
  829.          Late, or by inverting the list.
  830.     
  831.     3.   Notice that asterisks appear in the three columns that
  832.          contain the raw score and percentage for this test, and the
  833.          student's average.  The asterisk indicates there is no
  834.          score available, rather than a score of zero.  In fact, 'no
  835.          score' is the default value whenever a new student or test
  836.          name is entered, and remains thus until you enter a number.
  837.     
  838.     4.   Move the cursor to the 'raw score' column (the next column
  839.          over) and enter a raw score for this new student (the max-
  840.          imum score is shown at the top), and you'll see that a per-
  841.          centage is calculated, and also a student average.  In this
  842.          case, the student average is just the score obtained on
  843.          this one test.  A raw score can be specified to one decimal
  844.          place, may not be smaller than zero, and may be as large as
  845.          nine times the maximum score.
  846.     
  847.     5.   Press Alt-Z anywhere on this line, and the new student's
  848.          name appears at the top of the STUDENT screen.  On the list
  849.          of tests, you can spot the score you just entered, and note
  850.          that all other scores are 'no scores'.
  851.     
  852.     6.   Move to the top line and enter a homeroom and student
  853.          number; remember that these two categories are defined by
  854.          the teacher to be anything you like.  On the second line,
  855.          note the letter grade based on the student average.
  856.     
  857.     7.   Just to see what happens, edit the raw score you just
  858.          entered, and type an asterisk.  You'll notice that the
  859.          student average and letter grade appear as asterisks.  Now
  860.          enter a zero for the raw score, and again note the changes.
  861.     
  862.     
  863.     A New Test
  864.     ~~~~~~~~~~
  865.     1.   Stay on the STUDENT screen, and move down to the blank line
  866.          just below 'Proj.1'.  Enter the name of a new test, which
  867.          we'll call 'Essay1'.
  868.     
  869.     2.   Move right to the next column, and press the space bar.
  870.          Today's date will pop up, which you can either accept by
  871.          pressing RETURN, or reject by pressing any other key and
  872.          entering your own, in any format you wish.  NOTE: today's
  873.          date will not come up if your clock/calendar isn't set
  874.          correctly.
  875.     
  876.     3.   You can now enter a maximum score (say 30) in the next
  877.          column.  A maximum score must always be a whole number, and
  878.          cannot be zero.   If you change a maximum score after a set
  879.          of raw scores has been entered, the new maximum score can
  880.          be no smaller than 1/9 of the largest raw score entered;
  881.          more on this later.
  882.     
  883.     4.   Next, move to the 'Wgt%' column.  You can see that the
  884.          total weight (TotWgt) is less than 100%, so you can enter a
  885.          weight for this test; let's make it 2% (just type a '2').
  886.     
  887.     
  888.                                    - 14 -
  889.     
  890.     
  891.     
  892.          The edit box will always show you the maximum weight that
  893.          may be entered, by first subtracting any weight that might
  894.          already be in the cell you are editing.
  895.     
  896.     5.   Zoom on the test you have just entered (anywhere in the
  897.          row).  The test name is now at the top of the screen, and
  898.          you can fill in the TOPIC (test description): 1500 words on
  899.          'Molecules I Have Known'.
  900.     
  901.     6.   Notice that all raw scores and percentages for this new
  902.          test are 'no scores', which is the default until scores are
  903.          entered.  There are good reasons for leaving a score as 'no
  904.          score' until a final report is due.  These reasons will be
  905.          discussed in Report.
  906.     
  907.     
  908.     Attendance
  909.     ~~~~~~~~~~
  910.     1.   MTG can keep track of the number of days absent,
  911.          unexplained absences, and times late for each student.
  912.          Select a student from the list and press Alt-X.
  913.     
  914.     2.   Select which category you want to edit with the up/down
  915.          arrows, and change the numbers with the left/right arrows.
  916.          The figures always begin in normal text.  As soon as one
  917.          is increased or decreased, the background changes to red.
  918.          If you back up and pass the original setting again, it will
  919.          again show in normal text.
  920.     
  921.     3.   Pressing ESC once resets all figures to original values.
  922.          Press ESC again to close the box.  Press RETURN to make
  923.          changes permanent.  All counters increment from 0 to 999
  924.          and then return to zero.
  925.     
  926.     4.   Most teachers have their own method of recording
  927.          attendance, such as the time-honored 'little tick-mark on
  928.          the seating plan' system, and may not wish to use the one
  929.          in MTG, which is fine.  If you do elect to use this
  930.          feature, attendance data can be automatically inserted into
  931.          progress reports and attendance reports in the Report
  932.          module.  Report can also print up blank attendance sheets
  933.          (with students' names listed).
  934.     
  935.     
  936.     Deleting or moving a student offline
  937.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  938.          Over a period of time, students come and go.  If a student
  939.     leaves your class, you may decide to erase the student and all
  940.     score data from the file.  A better solution however, is to
  941.     simply move the student offline.  There are 15 storage locations
  942.     provided for students you want to remove from the active roster.
  943.     Their marks, averages and attendance figures are all preserved
  944.     for possible future use.  While a student is offline, that
  945.     student is removed from any calculations, graphs, or reporting
  946.     activity.  This is also a handy way to see what your class
  947.     average would be if a certain student, say Chuck Broccoli,
  948.     wasn't in your class -- move him temporarily offline.
  949.     
  950.     
  951.                               - 15 -
  952.     
  953.     
  954.     
  955.     1.   Move the cursor to any student and press Alt-D (as usual
  956.          putting the cursor anywhere in the row will identify
  957.          that student).
  958.     
  959.              1. Move Smith, John offline, keeping all data
  960.              2. Delete Smith, John and all relevant data.
  961.     
  962.          If you decide to delete the student, you'll be taken
  963.          through further prompts to give you every opportunity
  964.          to back out of the operation:
  965.     
  966.                       Delete: (student's name here)
  967.     
  968.                       and all relevant data?  Yes  No
  969.     
  970.     2.   Continue by pressing 'Y'.  MTG will now ask:
  971.     
  972.                         Are you really sure?  Yes  No
  973.     
  974.          Again, you can back out of the operation by pressing ESC.
  975.     
  976.     3.   Press 'Y' again.  The message:
  977.     
  978.                                   Deleting:
  979.     
  980.                              (student's name here)
  981.     
  982.          appears, and MTG will delete the student's name, raw
  983.          scores, average, attendance data, and both optional
  984.          categories containing student information.
  985.     
  986.     
  987.     Deleting a Test
  988.     ~~~~~~~~~~~~~~~
  989.          When a test is deleted, the weight, maximum score, test
  990.     name, test date, and test description are all erased, and the
  991.     total weight is adjusted accordingly  Then all student averages
  992.     are re-calculated, based on the remaining scores.  While you
  993.     cannot move a test offline, a simple way to remove it from any
  994.     calculations is to change its weight to zero.  You now have the
  995.     option of using the scores again later on, perhaps with a diff-
  996.     erent weight.
  997.     
  998.          Deleting a test follows the same steps used to delete a
  999.     student.  There are two opportunities to cancel the deletion.
  1000.     Once deleted, the data is permanently erased from memory.
  1001.     
  1002.     IMPORTANT: A deletion does not affect the file on disk, until
  1003.     ~~~~~~~~~  you SAVE the file to disk.  In other words, if you
  1004.                have accidentally deleted a test or student, you can
  1005.                retrieve the lost data from disk by immediately
  1006.                re-loading the file from Main Menu.
  1007.     
  1008.     
  1009.     Moving a student online
  1010.     ~~~~~~~~~~~~~~~~~~~~~~~
  1011.          To get a list of students that are offline, press Alt-O,
  1012.     and then select the student you wish to move online.  All class
  1013.     
  1014.     
  1015.                                - 16 -
  1016.     
  1017.     
  1018.     
  1019.     and test averages are immediately updated to reflect the change.
  1020.     
  1021.     
  1022.     Class Information
  1023.     ~~~~~~~~~~~~~~~~~
  1024.          Press Alt-C for a quick class summary.  Find out how many
  1025.     students are listed, how many students are offline, how many
  1026.     tests have been assigned, the standard deviation, class average
  1027.     and median, the number/percentage of 'no scores', total
  1028.     attendance figures, and the percentage/number of students
  1029.     failing.  This function is also available in Graph and Report.
  1030.     Use Prt Sc to get a hard copy.
  1031.     
  1032.     
  1033.     Temporary exit to DOS
  1034.     ~~~~~~~~~~~~~~~~~~~~~
  1035.          If you need to copy some files or format a disk, you can
  1036.     exit to DOS by pressing Alt-T (for Temporary exit).  As a
  1037.     precaution, you are warned to save the file you are working on
  1038.     if any changes have been made.  This is because there is no
  1039.     absolute guarantee that you will be able to return to the
  1040.     program, although if you exit just to perform some command line
  1041.     operations like formatting a disk, you should encounter no
  1042.     problems.  If you try to run other programs however, you may
  1043.     find that on returning to MTG, that screens are 'messed up' i.e.
  1044.     different colors, columns of data missing, etc.  This is usually
  1045.     because the other program you ran used some of the same video
  1046.     pages used by MTG.  In general there's no problem with ordinary
  1047.     DOS operations, but avoid running TSR's, word processors, etc.
  1048.     To re-enter MTG, type EXIT at the DOS prompt.
  1049.     
  1050.     
  1051.     Saving a File
  1052.     ~~~~~~~~~~~~~
  1053.          Pressing Alt-S saves the file to disk.  During a data entry
  1054.     session, you should save the file every fifteen minutes or so;
  1055.     that way, if the power is suddenly shut off, you won't have to
  1056.     re-enter as much data.
  1057.     
  1058.          If you have pressed Alt-S and suddenly realize you don't
  1059.     want to save the file, press ESC to cancel the save; the file on
  1060.     disk remains as it was, and you are returned to the spreadsheet.
  1061.          MTG uses the following method to save a file.  First a new
  1062.     file (^^TEMP^^.MTX) is created, and this is where your new data
  1063.     is stored.  When this temporary file has been saved and
  1064.     verified, the original file is deleted.  Finally, the temporary
  1065.     file is renamed to match your original file.  All this is
  1066.     transparent to the user, but this method minimizes the possi-
  1067.     bility of file corruption and data loss, compared to the usual
  1068.     method, which is to save the new file directly over the old.
  1069.     
  1070.     Quitting
  1071.     ~~~~~~~~
  1072.          To quit entering data, press Alt-Q.  MTG keeps track of
  1073.     whether you have entered any more data since the last save to
  1074.     disk, and asks if these changes should be saved before quitting.
  1075.     Press ESC to cancel the operation and return to the spreadsheet.
  1076.     
  1077.     
  1078.                                 - 17 -
  1079.     
  1080.     
  1081.     
  1082.     Press 'N' if you want to quit without saving recent changes, and
  1083.     'Y' if you wish to save the changes and then quit.
  1084.          If there have been no changes since the last save, this
  1085.     menu is displayed:
  1086.     
  1087.                     1.  Return to Main Menu
  1088.                     2.  Quit Making The Grade
  1089.     
  1090.          Returning to Main Menu allows you to work on another file,
  1091.     go to Change Setup, etc.  If you select 'Quit Making The Grade',
  1092.     MTG exits to DOS.
  1093.     
  1094.          You now have enough information to start a new file and
  1095.     enter your own class data.  Jump directly to QUICK START at this
  1096.     point, or continue to follow the tutorial, which next looks at
  1097.     Graph and Report.
  1098.     
  1099.                      ___________________________
  1100.     
  1101.     
  1102.     
  1103.     Using Graph
  1104.     ~~~~~~~~~~~
  1105.          With MTG you can produce a graph for a student, a test, or
  1106.     the whole class.  To graph an item, follow these steps.  First,
  1107.     select the file you wish to edit from Main Menu, and load the
  1108.     file.  If you are following the tutorial and have just quit to
  1109.     the Main Menu, re-load the sample file CHE.3A1!.
  1110.     
  1111.     
  1112.     Graphing a Student
  1113.     ~~~~~~~~~~~~~~~~~~
  1114.     1.   Move the cursor to: Thurston, Sheila and press Alt-G.
  1115.     This type of graph is called a 'cumulative average' bar
  1116.     graph.  The vertical axis is labelled with from one to eight
  1117.     test names.  If more than eight tests have been assigned so far,
  1118.     the last eight will be displayed on the graph, and a small white
  1119.     'down' arrow appears next to the start and end dates in the
  1120.     lower right corner.  By pressing the down arrow, the graph
  1121.     scrolls up the screen and you can go back as far as the first
  1122.     test. The horizontal axis shows the student's overall average as
  1123.     a weighted percentage. It is a cumulative graph,because each red
  1124.     bar shows a student's average at that time, in other words, just
  1125.     after that particular test was entered.  The green bar shows
  1126.     with the class average after that test, with the student's
  1127.     average subtracted out.
  1128.     
  1129.     
  1130.          If a student misses a test, a 'no score' shows as an
  1131.     asterisk just to the right of the test name, and the average is
  1132.     carried over from the last test written.  Under 'Last 3 tests:'
  1133.     you can see how much a student has lost or gained, compared with
  1134.     his/her average 4 tests ago, and compared with the rest of the
  1135.     class.  As you scroll the graph up and down, the start and end
  1136.     dates, and the trend over the last three tests change to reflect
  1137.     the portion of the graph you are looking at.  If a student's
  1138.     average is greater than 100%, a '>' at the end of the bar shows
  1139.  
  1140.  
  1141.                                  - 18 -
  1142.  
  1143.  
  1144.  
  1145.     that it extends beyond 100%.   Note: This is great stuff for
  1146.     parent/teacher nights if you want parents to get the big pic-
  1147.     ture.
  1148.     
  1149.          To print a graph, make sure your printer is in IBM mode and
  1150.     press Prt Sc.  Press Pg Up or Pg Dn to page through the other
  1151.     students. To return to Edit press Alt-E, or press ESC for a list
  1152.     of options.  Alt-H displays the Help screen for Graph. (Press
  1153.     the space bar to hide those white arrows prior to printing).
  1154.  
  1155.     
  1156.     Graphing a Test
  1157.     ~~~~~~~~~~~~~~~
  1158.          Select any test you wish from the list, and press Alt-G.
  1159.     This graph is a 'frequency distribution'.  Each interval on the
  1160.     horizontal axis contains 10 percentage points: 0-9, 10-19, and
  1161.     so on.  (The last interval cheats a little and includes 100, for
  1162.     a total of 11 points.)  The vertical axis shows the frequency --
  1163.     in this case, how many test results fall within a particular
  1164.     grade interval.  For example, percentages of 51, 54, 55, and 59
  1165.     all fall within the interval 50-59, and the frequency is 4.  If
  1166.     a frequency is greater than 16, the actual frequency is shown at
  1167.     the top of the bar. The title includes the weight for that test.
  1168.          To the right are listed some useful statistics: the average
  1169.     on this particular test, the median, standard deviation (SD),
  1170.     range of scores, number of scores, and percentage/number who
  1171.     failed the test.
  1172.     
  1173.     
  1174.     Adjusting Grades
  1175.     ~~~~~~~~~~~~~~~~
  1176.          One technique for adjusting scores is known as 'grading on
  1177.     the curve', while another assigns letter grades according to a
  1178.     formula: so many A's, so many B's, so many C's, etc.  All
  1179.     methods of adjustment tend toward a common goal: center the
  1180.     scores about an ideal mean, i.e. a figure the teacher (or
  1181.     administration) selects to represent the average student, and
  1182.     secondly, control the amount of spread between highest and
  1183.     lowest scores, or in other words, adjust the standard deviation
  1184.     to our requirements.
  1185.     
  1186.          In a typical class, the scores are almost always dispersed
  1187.     more widely then a normal distribution curve.  Take a moment to
  1188.     look through some of the test graphs from the sample file, and
  1189.     note how many standard deviations exceed 15 and even 20.
  1190.     Compared to a normal distribution, more students' scores fall at
  1191.     the low and high ends of the curve.  Recall that in a normal
  1192.     distribution of scores between 0 and 100, one standard deviation
  1193.     has a value of approximately 10.
  1194.     
  1195.          To adjust a set of scores therefore, you need to do two
  1196.     things: move the scores toward a new mean that you have set, and
  1197.     either narrow or broaden the curve.  The formula for doing this
  1198.     correctly is as follows:
  1199.     
  1200.     
  1201.                                 - 19 -
  1202.     
  1203.     
  1204.     
  1205.        New score = New mean + ((Old score - Old mean)
  1206.     
  1207.                    x New SD / Old SD)
  1208.     
  1209.          MTG does these calculations for you.  Follow the steps
  1210.     below to practice adjusting scores.
  1211.     
  1212.     1.   Begin by graphing one of the sample tests.  Then press ESC
  1213.          to bring up the 'Options' menu.
  1214.     
  1215.     2.   Select 'Try another mean and SD' from the menu.  Another
  1216.          box pops up, and from here you can either accept the
  1217.          default standard deviation and mean (17 and 70%), or use
  1218.          the left and right arrows to change them.  Press RETURN
  1219.          when finished, or ESC to back up a step.
  1220.     
  1221.     3.   MTG will graph the new data according to the mean and
  1222.          standard deviation you have set, adjacent to the original
  1223.          graph for comparison.  The new mean, median, SD, range, and
  1224.          number failing are also displayed.
  1225.     
  1226.     NOTE: This will not alter the original scores, either in memory,
  1227.     ~~~~  or on disk.  The new scores resulting from the changes you
  1228.           have made are only temporary and are eventually discarded.
  1229.           Thus, you can continue to try other means and standard
  1230.           deviations, without fear of losing important data.
  1231.     
  1232.     TIP: If you teach statistics in a Math course, Graph can be used
  1233.     ~~~  to teach some of the basic concepts in a highly visual and
  1234.          interactive way.
  1235.     
  1236.     4.   You can go a step further at this point, and see the actual
  1237.          scores that would result, were you to make the adjustments
  1238.          permanent.  Press ESC again to bring up the 'Options' menu.
  1239.          Select 'Look at the adjusted data'.  The first column of
  1240.          figures shows the original percentage scored by each
  1241.          student on the test.  The second column shows the new
  1242.          percentage, and the third column shows the raw score a
  1243.          student would need to produce the new percentage.
  1244.     
  1245.     5.   If you would like to print this screen, switch the printer
  1246.          on first, and then press Alt-H.  ESC will return you to the
  1247.          graph.
  1248.     
  1249.     NOTE: I purposely left out the capability to automatically
  1250.     ~~~~  insert these new raw scores into a file.  I feel that this
  1251.           capability would encourage a certain amount of quick and
  1252.           careless adjustment of marks; a student's academic record
  1253.           is too important for idle tampering.  The hard copy how-
  1254.           ever, allows you to go back and enter the adjusted raw
  1255.           scores by hand on the Edit screen (not a huge task, but
  1256.           enough to discourage casual adjustments).
  1257.     
  1258.     
  1259.     Graphing a Class
  1260.     ~~~~~~~~~~~~~~~~
  1261.          To graph the class, go to either the TEST or STUDENT
  1262.     
  1263.     
  1264.                               - 20 -
  1265.     
  1266.     
  1267.     
  1268.     screen, move the cursor over the class name (CHE.3A1 in the
  1269.     sample file), and press Alt-G.  The frequency distribution graph
  1270.     shows the distribution of student averages, and is similar the
  1271.     the test graph.  The mean and standard deviation can be adjusted
  1272.     here as well, and in fact, this is where adjustments are usually
  1273.     made, at the end of the semester or school year.
  1274.     
  1275.     
  1276.     Other Ways to Adjust Scores
  1277.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1278.          MTG makes it easy to adjust scores globally, or on an
  1279.     individual basis.  To lessen the overall effect of a particular
  1280.     test, simply reduce its weight.  To remove it entirely, either
  1281.     delete the test, or set its weight to zero.  ** See Addendum 2.0
  1282.     at the end of this doc for more information on weights.
  1283.          If for some reason you wish to make the maximum score
  1284.     higher or lower, this can be done even after the raw scores have
  1285.     been entered; a maximum score can be as large as 999.
  1286.     
  1287.          A raw score can be as big as nine times the maximum (to a
  1288.     possible 8991), which allows extra credit to be awarded.  This
  1289.     feature is also useful if, for example, a student has missed a
  1290.     test, or has just joined the class and marks are needed to
  1291.     generate a grade for assessment.  By doubling his/her raw score
  1292.     on another test of equal worth, you can compensate for missing
  1293.     data.
  1294.     
  1295.          Some teachers prefer to drop each student's lowest score at
  1296.     the end of the course.  This is easily done by entering an
  1297.     asterisk, which converts the low score to 'no score'.  CAUTION:
  1298.     to be fair, only scores of equal weight should be dropped.  If a
  1299.     test worth 10% is dropped for one student, and a quiz worth 2%
  1300.     is dropped for another student, based solely on these being
  1301.     their lowest scores, the first student gains an advantage over
  1302.     the second.
  1303.     
  1304.     
  1305.     More Than 40 Sets of Scores?
  1306.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1307.          When you 'Duplicate an existing roster' (under 'Start a new
  1308.     class'), you have the option of carrying forward all student
  1309.     averages and attendance data from the first file.  This is use-
  1310.     ful if you have more than 40 sets of scores in a semester, or if
  1311.     you want to carry averages and attendance data forward to the
  1312.     next term.  When the roster to be duplicated has loaded, you are
  1313.     asked:
  1314.     
  1315.                      Forward student averages?  Yes  No
  1316.     
  1317.                      Forward attendance data?  Yes  No
  1318.     
  1319.         If you choose to keep the student averages, the following
  1320.         happens:
  1321.     
  1322.         a. A new test name called 'So.Far' is created in the new
  1323.            file.  The maximum score is 100, the weight is the total
  1324.            weight from the other file, and the raw scores are the
  1325.     
  1326.     
  1327.                                   - 21 -
  1328.     
  1329.     
  1330.     
  1331.            student averages from the other file.  The test average
  1332.            is calculated from these student averages, so it also
  1333.            represents the class average at this point!  A test
  1334.            description is entered for you: Student averages to
  1335.            date.  Change the test name (TERM.1 for example) and the
  1336.            description to whatever you like, and you may also want
  1337.            to enter a date for the transfer, under TDate.
  1338.     
  1339.            If this file is merely a continuation of the same term
  1340.            or semester, you will probably want to leave the weight
  1341.            as is; it represents the total weight so far.  If you're
  1342.            beginning a new term however, and the previous term only
  1343.            contributes (say) 30% toward the final grade, now is the
  1344.            time to adjust the weight of this 'test'.  In this way,
  1345.            your new file accurately reflects the year's progress
  1346.            for each student.  If you like, temporarily make the
  1347.            weight for 'So.Far' zero.  Now you can see how students
  1348.            are progressing just in this term, and the weight for the
  1349.            first term can be re-entered later on.
  1350.     
  1351.       CAVEATS
  1352.       ~~~~~~~
  1353.         Before carrying the student averages forward, the old file
  1354.         should be as complete as possible. That is, all 'no scores'
  1355.         should be resolved; are they zeros or 'no scores'?  The
  1356.         weight and maximum score you assigned for each test should
  1357.         also be finalized.  The reason is simple: these data all
  1358.         affect the student averages, which you are carrying forward
  1359.         into another file.  If, for some reason, you must go back
  1360.         and change something in the old file, and this change
  1361.         alters one or more student averages, you have to be sure
  1362.         to copy these changes by hand into test 1 in the new file.
  1363.         Tip: in Edit, bring up a Test screen, which lists all
  1364.         student averages in a column, and press Prt Sc.  This gives
  1365.         you a handy reference to update the new file, in case any
  1366.         late changes have to be carried forward.
  1367.     
  1368.         One advantage of the above method is that you know a stu-
  1369.         dent's over-all standing at any time, and not only his
  1370.         standing for a particular term.  If the arithmetic seems a
  1371.         little convoluted, practice with the sample file to famili-
  1372.         arize yourself with how it works.  You may still prefer to
  1373.         keep each term completely in its own file, but this means
  1374.         the final grades will have to be calculated by hand at the
  1375.         end of the year.
  1376.     
  1377.     Since a weight can be as little as 0.1%, and the total weight
  1378.     can be as big as 100%, as many as 1000 sets of scores can be
  1379.     accommodated, although it's unlikely you'll ever need this many.
  1380.     The method of carrying averages forward, outlined above, can be
  1381.     applied to several files in succession.  The file at the end of
  1382.     the 'chain' will still accurately reflect the year's work.  Just
  1383.     be certain that any retroactive change you make is entered man-
  1384.     ually into successive files.
  1385.     
  1386.     
  1387.     
  1388.     
  1389.                                   - 22 -
  1390.     
  1391.     
  1392.     
  1393.     Keep attendance data?
  1394.     ~~~~~~~~~~~~~~~~~~~~~
  1395.         Decide whether you want to carry forward absences, unauth-
  1396.         orized absences, and lates into another file.  If the new
  1397.         file is a continuation of the same term or semester, it
  1398.         makes sense.  If the new file starts a new term, it may
  1399.         make more sense to maintain a discrete record for each
  1400.         term.
  1401.     
  1402.     
  1403.     
  1404.     Using Report
  1405.     ~~~~~~~~~~~~
  1406.          To use Report, first select a file to edit from Main Menu
  1407.     (use the sample file CHE.3A1 for practice).  When you reach the
  1408.     Edit screen, press Alt-R, which takes you to Report.  You can
  1409.     also go to Report from Graph, either by pressing Alt-R, or by
  1410.     selecting 'Go to Report' from the 'Options' menu, and then
  1411.     'Prepare a report'.  Follow the steps below to produce each type
  1412.     of report.
  1413.     
  1414.     IMPORTANT: Report expects you to have at least entered a class
  1415.     ~~~~~~~~~  list.  This enables you to print attendance reports,
  1416.                blank attendance charts, student information reports,
  1417.                and a few others.  Other reports, such as the
  1418.                gradebook, missing assignment, and progress reports,
  1419.                require at least one set of scores to work with.
  1420.     
  1421.                As well, you should check the printer setup before
  1422.                preparing a report to see that your printer is
  1423.                correctly installed.  To do this, go to Change Setup
  1424.                from Main Menu, and then select 'Choose a printer'.
  1425.                Your printer must also be in non-IBM mode to access
  1426.                the correct printer codes.  (This is a nuisance, be-
  1427.                cause the printer must be switched to IBM mode to
  1428.                print graphs and other screens correctly.  Unfort-
  1429.                unately, some of the needed printer codes are unsup-
  1430.                ported in IBM mode on many printers.)
  1431.     
  1432.     Progress Report
  1433.     ~~~~~~~~~~~~~~~
  1434.     
  1435.     1.   You are first asked:
  1436.     
  1437.                    Print a report for every student? (Y/N)
  1438.     
  1439.          The default reply is 'Yes', so just press RETURN if you
  1440.          wish to do the whole class.
  1441.     
  1442.     2.   If you reply 'No', the class list is displayed.  Use the up
  1443.          and down arrows to move to a student, and press the space
  1444.          bar to select the student; a marker appears to the left
  1445.          of the name you have selected.  To de-select a name, again
  1446.          press the space bar.  To de-select all names and start
  1447.          over, press ESC.  Press RETURN when you're finished.
  1448.     
  1449.     3.   There are 120 comments available (60 English, 30 French,
  1450.          and 30 blank), and they can be edited with any word pro-
  1451.     
  1452.     
  1453.                                   - 23 -
  1454.     
  1455.     
  1456.     
  1457.          cessor to suit your needs.  The last page of comments gives
  1458.          instructions for changing the comments to something else.
  1459.          MTG now lists the comments (30 on each screen, press Pg Up
  1460.          or Pg Dn to cycle through pages 1 to 4). A name is dis-
  1461.          played at the bottom, along with average and attendance
  1462.          information. You can select one or two comments from either
  1463.          screen, by pressing the space bar on a comment.  Press
  1464.          RETURN when finished with a student, i.e. after one or two
  1465.          comments have been selected.  If you select no comments at
  1466.          all, underscored blank lines are printed instead, and you
  1467.          can enter remarks by hand after the reports are printed.
  1468.     
  1469.          You are then prompted:
  1470.     
  1471.                    RETURN for next student,
  1472.                    ESC to back up
  1473.     
  1474.          If you are not satisfied with the comments selected, this
  1475.          is your last chance to change them.  Press RETURN to
  1476.          advance to the next student.
  1477.     
  1478.     4.   The second line from the top tells you how many students
  1479.          remain after the one you're working on, and which page of
  1480.          comments you are looking at.
  1481.     
  1482.     5.   Next, press Pg Up/Pg Dn to select the date format you wish
  1483.          to print, and press RETURN.  The four available formats
  1484.          are:
  1485.     
  1486.                                91/01/13
  1487.     
  1488.                                13 Jan 91
  1489.     
  1490.                                Jan 13, 1991
  1491.     
  1492.                                91-01-13
  1493.     
  1494.     6.   From the two columns, select the title you wish to display
  1495.          above 'PROGRESS REPORT'.  Choose 'Blank' from both columns
  1496.          if you don't want any title.  Press ESC to start over.
  1497.     
  1498.     7.   MTG then asks you which attendance data should appear in
  1499.          the report.  The defaults are YES for 'Days absent', NO for
  1500.          'Unexplained absences', and NO for 'Times late'.  Select
  1501.          any combination you wish.
  1502.     
  1503.          MTG uses information from the attendance records entered
  1504.          during Edit.  If you haven't been using this feature, but
  1505.          still wish to show 'Days absent', answer NO to all three.
  1506.          MTG will then print a 'Days absent' column with underscored
  1507.          blanks, so you can enter your own data by hand afterwards.
  1508.     
  1509.     8.   Decide whether you want 'Near Letter Quality' or 'Draft'.
  1510.          (This option will appear only if your printer supports
  1511.          NLQ.)
  1512.     
  1513.     9.   Select the number of copies you want to print.  This does
  1514.     
  1515.     
  1516.                                   - 24 -
  1517.  
  1518.  
  1519.     
  1520.          not refer to how many individual reports, but to how many
  1521.          times you wish to print the entire set of reports.  You
  1522.          then see:
  1523.     
  1524.              Turn printer on, with print head at perforation.
  1525.     
  1526.              Press RETURN when ready.
  1527.     
  1528.          The perforation should be even with the top of the print
  1529.          head (the part that goes back and forth).  MTG inserts its
  1530.          own linefeeds where necessary, so don't worry about
  1531.          starting too close to the top.  Two reports are printed per
  1532.          page, which can then be cut in half.  Two extra blank
  1533.          lines are printed under the selected comments, so you can
  1534.          write something else by hand if you wish.
  1535.     
  1536.     10.  Finally, you can press any key during printing to stop
  1537.          printing.  If you do this, also turn the printer off, since
  1538.          most printers have at least a 2K buffer of their own which
  1539.          will continue to output characters.
  1540.     
  1541.     NOTE: The shareware version of MTG prints a row of underscores
  1542.     ~~~~  after 'Teacher:' instead of your name.  The commercial
  1543.           version prints your name here.
  1544.     
  1545.     
  1546.     Gradebook Report
  1547.     ~~~~~~~~~~~~~~~~
  1548.          This report gives a typical spreadsheet-like printout of
  1549.     all students, tests, scores, percentages, weights, etc.
  1550.     Nine tests can be printed per page.  The column to the
  1551.     extreme right shows each student's current average, and the
  1552.     underscored number in the lower right hand corner is the
  1553.     current class average.
  1554.     
  1555.     1.   You are asked if you want to print every test.  Since they
  1556.          are printed in groups of nine, you may only need to print
  1557.          the last page of tests.  For example, if your file contains
  1558.          13 tests so far, and you have printed gradebook reports
  1559.          before, you need only print from test #10 to #13, and add
  1560.          this page to your printed records (unless you have made
  1561.          adjustments to earlier tests since the last printout).
  1562.     
  1563.     2.   If you don't want to print every set of scores, you are
  1564.          then asked to select a range of tests.  Press the space bar
  1565.          to select a starting point, move to the finish point, and
  1566.          press the space bar again.  To print one test, select the
  1567.          same test for start and finish.  Press ESC to start over.
  1568.     
  1569.          That's all there is to it.  You should print this report
  1570.     after each data entry session.  It provides a paper-based record
  1571.     of all vital data, and supplements the back-up copy of your data
  1572.     disk.  If your data disks were somehow erased tomorrow, you
  1573.     could re-construct the file from this printout.  Play it safe!
  1574.     
  1575.     
  1576.     
  1577.     
  1578.                                   - 25 -
  1579.     
  1580.     
  1581.     
  1582.     Attendance Report
  1583.     ~~~~~~~~~~~~~~~~~
  1584.          If you have been using the built-in attendance feature, and
  1585.     have kept it up to date, the attendance report gives a complete
  1586.     summary of days absent, unexplained absences, and times late for
  1587.     each student (or any combination of these three).  By answering
  1588.     NO to all three, a 'days absent' column will be printed with
  1589.     underscored blanks, so you can enter the figures from your own
  1590.     records by hand if you wish.
  1591.     
  1592.     
  1593.     Student Information Report
  1594.     ~~~~~~~~~~~~~~~~~~~~~~~~~~
  1595.          This report will list the contents of the two optional
  1596.     categories (the default is 'Homeroom' and 'Student Number').
  1597.     You can list either, or both.  If you specify neither, the two
  1598.     headings will be printed, with underscored blanks where the data
  1599.     usually appears.  TIP: this blank report is useful at the start
  1600.     of the year for gathering data; you can later enter the
  1601.     information into MTG.
  1602.     
  1603.     
  1604.     Missing Assignments Report
  1605.     ~~~~~~~~~~~~~~~~~~~~~~~~~~
  1606.          This report lists each student who has missing tests, along
  1607.     with the name of each test.  MTG determines that an test is
  1608.     missing if a raw score is a 'no score', another good reason for
  1609.     keeping the 'no score' status as long as possible, rather than
  1610.     immediately entering a zero.  At the end of the listing, a
  1611.     separate page lists each test name, and the test description
  1612.     beside it.
  1613.          Beside each student and the list of missing assignments, is
  1614.     the student's current average, and what his average will be if
  1615.     the missing assignments are not completed.  Print the report
  1616.     with student numbers if you want to post the list on a bulletin
  1617.     board.
  1618.     
  1619.     
  1620.     Class Summary Report
  1621.     ~~~~~~~~~~~~~~~~~~~~
  1622.          This report lists all students and their current averages,
  1623.     shown as a percentage and a letter grade. The number of students
  1624.     in the class is included, and also the number/percentage who are
  1625.     failing.  The Class Summary report also checks to see whether or
  1626.     not you are using the attendance tracking feature in Edit.  If
  1627.     any non-zero figure is found for Total Absences, the Class Sum-
  1628.     mary report will include an extra column listing the total ab-
  1629.     sences for each student.  This feature is handy when filling in
  1630.     report cards, where both the grade and number of absences are
  1631.     are required.
  1632.     
  1633.          Many schools, at the end of the school year, raise a grade
  1634.     that is within 3 marks of passing to a pass, and also raise a
  1635.     bare pass by one mark.  For example, if the passing grade is
  1636.     50%, grades between 47% and 49% are raised to a 50%, and a
  1637.     legitimate grade of 50% is raised to a 51% (to distinguish it
  1638.     from a raised pass).  MTG will do these manipulations if you
  1639.     
  1640.     
  1641.                                 - 26 -
  1642.     
  1643.     
  1644.     
  1645.     wish (based on whatever passing grade you have installed); a
  1646.     raised pass will print in bold face, and will be underscored.
  1647.     
  1648.     
  1649.     Blank Attendance
  1650.     ~~~~~~~~~~~~~~~~
  1651.          This report is simply a class list with a blank for the
  1652.     month at the top, and a grid for recording absences, lates, etc.
  1653.     There are five blank lines at the bottom for new students, and
  1654.     also a blank line to record totals each day.  This blank report
  1655.     can easily be used as an order form or a tally sheet.
  1656.     
  1657.     
  1658.     Blank Seating Plan
  1659.     ~~~~~~~~~~~~~~~~~~
  1660.          Specify how many seats across the front, and how many seats
  1661.     deep, and MTG will print a blank seating plan that fits the size
  1662.     of your classroom.  The plan can be dimensioned from 2 x 5 up to
  1663.     12 x 12 (after an exhaustive survey of area teachers, the author
  1664.     concluded that hardly anyone needs a 1 x 1 seating plan).  The
  1665.     blank seating plan is also useful any time you need a grid or
  1666.     game board of a particular size, or for making a bunch of paper
  1667.     strips, which you can then cut out.
  1668.     
  1669.     
  1670.     Score Sheet
  1671.     ~~~~~~~~~~~
  1672.         This is similar to the blank attendance report, but has
  1673.     wider columns for entering raw test scores.  Normally, it is
  1674.     recommended that scores be entered directly into Edit from the
  1675.     test papers (less chance of an error).  The mark sheet is handy
  1676.     when work is marked right in class, and can also be used as a
  1677.     general purpose tally sheet.
  1678.     
  1679.                            __________________
  1680.     
  1681.     
  1682.     
  1683.     New Features (versions 1.1 through 1.5)
  1684.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1685.     This shareware program is version 1.5 and thus contains all of
  1686.     the new features described below:
  1687.     
  1688.     Version 1.1, July 8, 1990
  1689.     ~~~~~~~~~~~~~~~~~~~~~~~~~
  1690.     1. Arranging By Test Results
  1691.        ~~~~~~~~~~~~~~~~~~~~~~~~~
  1692.          You can now sort the roster based on the results of a test
  1693.     or assignment you have just marked, or perhaps a previous set of
  1694.     scores.  To do this, bring the test you want to sort into the
  1695.     Test screen (i.e. so that 'TEST.1' for example is at the top of
  1696.     the screen).  Next press Alt-A to bring up the Arrange menu, and
  1697.     you should see 'Results of TEST.1' on the list of options.  Move
  1698.     down the list and select this option; the student list will sort
  1699.     in descending order based on the figures in the 'Per' column.
  1700.     The feature is not available when the test average is less than
  1701.     zero (i.e. no scores have been entered yet).
  1702.     
  1703.     
  1704.                                 - 27 -
  1705.     
  1706.     
  1707.     
  1708.     2. Individual Grade Report
  1709.        ~~~~~~~~~~~~~~~~~~~~~~~
  1710.          From the Report menu, individual grade reports can be
  1711.     printed for selected students or for the entire class, for a
  1712.     selected range of tests or for all tests.  Each report in-
  1713.     cludes test names, scores, weights, test averages, the stud-
  1714.     ent's over-all average and attendance figures, and class
  1715.     average.  This report is suitable for including with a pro-
  1716.     gress report or as a transcript if a student transfers to
  1717.     another class or another school.
  1718.     
  1719.     
  1720.     3. Group Weight Adjustment
  1721.        ~~~~~~~~~~~~~~~~~~~~~~~
  1722.          Although the total weight need never sum to 100 percent,
  1723.     the Group Weight Adjustment feature allows you to do precisely
  1724.     that, among other things.  Here are a couple of scenarios in
  1725.     which this feature can be useful:
  1726.     
  1727.     a.   At the start of the term, you decided that term work will
  1728.     be worth 60% and the final exam 40%.  At the end of the term
  1729.     however (before the exam), the total weight is greater than 60%
  1730.     or less than 60%, which is no problem).  Group Weight Adjust-
  1731.     ment lets you reduce a total weight of say 75%, to 60%, distri-
  1732.     buting the reduction in the correct proportion among individual
  1733.     est weights.  This is done precisely as you would do by hand
  1734.     with a calculator.  You can now allot exactly 40% for the final
  1735.     exam.
  1736.     
  1737.     b.   You wish to adjust the weights of only some tests.  For
  1738.     example, you notice that the six labs you have assigned have a
  1739.     total weight of 30%, and you would prefer (perhaps because they
  1740.     were so poorly done) to reduce this total to 20%. Group Weight
  1741.     Adjustment lets you select any group of tests and then specify a
  1742.     new total weight for that group.
  1743.     
  1744.     
  1745.     Using Group Weight Adjustment
  1746.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1747.          Before doing any adjustments, the current file should be
  1748.     saved, including any new data that has been entered.  You should
  1749.     then make a hard copy of both screens (any Test screen and any
  1750.     Student screen) by pressing Prt Sc.  Then move to a Student
  1751.     screen (which shows all test weights) and press Alt-W:
  1752.     
  1753.     Current total weight is: 75% -- adjust ALL weights?  YES  NO
  1754.     
  1755.     In a case like that in (a), answer YES.  You are then prompted
  1756.     for a new weight.  There are a few things to consider when
  1757.     choosing a new weight:
  1758.     
  1759.     1.   The program requires that there be a large enough diff-
  1760.          erence between the old total weight and the new total
  1761.          weight you have entered.  If the difference is too small, a
  1762.          significant rounding error tends to accumulate and it
  1763.          becomes very difficult to maintain the correct ratio of one
  1764.          test weight to another.  A rounding error results whenever
  1765.          you must round a newly calculated weight to one decimal
  1766.     
  1767.     
  1768.                                 - 28 -
  1769.     
  1770.     
  1771.     
  1772.          place, which is the maximum precision you are allowed.  To
  1773.          prevent gross inaccuracies, MTG requires the difference
  1774.          between new total weight and old total weight to be 0.2 x
  1775.          the number of test weights being adjusted.  For example if
  1776.          there are 12 tests in the group of weights to be adjusted
  1777.          and the current total weight for that group is 75%, then
  1778.          the new total weight must be either greater than 77.3% or
  1779.          less than 72.7%.  Don't be overly concerned about this --
  1780.          MTG will alert you if there's a problem and will not at-
  1781.          tempt to make the adjustment.
  1782.     
  1783.     2.   Remember that weights of 0% will be unaffected by a group
  1784.          weight adjustment because zero x any weight adjustment
  1785.          ratio is still zero.
  1786.     
  1787.     3.   If the new total weight you have entered is much smaller
  1788.          than the original weight, there is a possibility that one
  1789.          or more test weights will reduce to zero through rounding.
  1790.          MTG does the calculations and then warns you of this situ-
  1791.          ation.  You then have the option of continuing or backing
  1792.          out.
  1793.     
  1794.     4.   After MTG has done the calculations, there is often a
  1795.          small, cumulative rounding error, typically between 0.1%
  1796.          and 0.3%, positive or negative.  MTG reports this error and
  1797.          then asks permission to make up the difference by adding or
  1798.          subtracting the error from the largest weight in the group
  1799.          you have selected.  Making a corrective adjustment to the
  1800.          largest weight results in the least amount of error (you
  1801.          can see at a glance that one penny is missing from a pile
  1802.          of ten, but not from a pile of one hundred).
  1803.     
  1804.          With permission, MTG makes the changes and then advises
  1805.          that you may wish to make further minor adjustments by hand
  1806.          (e.g. take that +0.3%, split it in three and distribute the
  1807.          parts more evenly).  Or you can back out of the operation
  1808.          and try something else.  Note that many of your tidy, whole
  1809.          number weights will become decimal fractions after a weight
  1810.          adjustment.
  1811.     
  1812.     5.   Another consequence of rounding error is that a weight ad-
  1813.          justment is usually irreversible.  In other words if you
  1814.          change the total weight from 75% to 60% and then back to
  1815.          75%, it's unlikely you'll have the same individual test
  1816.          weights you began with.  Rounding errors are made and com-
  1817.          pensated for in both directions so that the adjustment is
  1818.          made to a different set of numbers each time.  This is why
  1819.          you are asked to get a hard copy of the Student screen --
  1820.          if necessary the original weights can be entered by hand,
  1821.          or you can simply reload the file.
  1822.     
  1823.     6.   When all weights are adjusted, student averages should re-
  1824.          main exactly as before.  Check them against the hard copy
  1825.          you made of a Test screen however -- rounding error may
  1826.          have changed one or two slightly.
  1827.     
  1828.     
  1829.     
  1830.     
  1831.     
  1832.                                 - 29 -
  1833.     
  1834.     
  1835.     
  1836.          If you answered NO to 'adjust ALL weights?', you can now
  1837.     move the cursor around, pressing the space bar to select each
  1838.     weight you want to change; the cumulative total of these weights
  1839.     is shown at the top of the screen.  The same restrictions and
  1840.     cautions apply as those outlined above, with this additional
  1841.     caveat:  when changing only a group of weights from among many,
  1842.     student averages will almost certainly change, often by an ap-
  1843.     preciable amount.  Be sure to compare the newly calculated ave-
  1844.     rages with the old (from your screen hard copy) to see whether
  1845.     the desired result was achieved.  Remember that adjustments are
  1846.     also applied to students that are offline.
  1847.     
  1848.          Finally, if you are uncertain of the principles and
  1849.     arithmetic involved in weight adjustment, experiment with the
  1850.     sample file CHE-3A1! provided on the program disk.  If you're
  1851.     still hesitant to use Group Weight Adjustment, it's probably
  1852.     best that you don't use it; misused, it can create havoc.
  1853.     
  1854.                        ________________________
  1855.     
  1856.     
  1857.     
  1858.     Version 1.2, August 1, 1990
  1859.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1860.     1. Arranging By Random Selection
  1861.        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1862.          If for some reason you wish to randomly scramble the order
  1863.     in which students are listed, select 'Arrange By Random Sel-
  1864.     ection' from the Arrange menu (Alt-A).  You might want to do
  1865.     this when posting test results by student number so that results
  1866.     are posted in no particular order, or to decide in what order
  1867.     presentations will be given (so that Aaron A. Aardvark doesn't
  1868.     always go first).
  1869.     
  1870.     
  1871.     2. Setting The Trend Period
  1872.        ~~~~~~~~~~~~~~~~~~~~~~~~
  1873.          By default, Class Stats (Alt-C) gives the class trend for
  1874.     the last three tests.  This trend is calculated by first finding
  1875.     the class average three tests before the set of scores you last
  1876.     entered, and substracting that from the current class average.
  1877.     For example, if the last test you entered scores for was Test.6,
  1878.     and the three tests previous to that are numbered Test.5,
  1879.     Test.4, and Test.3, then the class average after Test.3 is sub-
  1880.     tracted from the class average after Test.6.  This results in a
  1881.     positive, negative, or zero change, indicating how the class
  1882.     performed as a whole during this period.
  1883.     
  1884.          The default trend period is three, but can be anything from
  1885.     the last two to the last nine tests.  Press Alt-P (for trend
  1886.     Period) in Edit or Graph, and use the arrow keys to select a new
  1887.     trend period.  If you select a trend period that is too large
  1888.     for the number of tests in the file, the trend value will simply
  1889.     be unavailable.  The new trend period is not saved between sess-
  1890.     ions; it will be 3 again next time you run MTG.
  1891.     
  1892.          The same trend period is used when you graph a student
  1893.     (Alt-G).  In the lower right hand corner is the caption 'Last 3
  1894.     
  1895.     
  1896.                                 - 30 -
  1897.     
  1898.     
  1899.     
  1900.     tests:' (or whatever trend period you have set).  Below this
  1901.     caption is the trend for both student and class during this per-
  1902.     iod.  If there are more than eight cumulative averages on the
  1903.     graph, you can scroll with the up/down arrows to see the rest of
  1904.     the graph.  When you scroll the graph, the trend is updated as
  1905.     well, calculating from whichever test is displayed at the top of
  1906.     the graph.  Note that test dates are also updated.  Experiment
  1907.     with this feature to see how it works (it's easier to see than
  1908.     to explain).
  1909.     
  1910.     
  1911.     3. Arranging By Trend
  1912.        ~~~~~~~~~~~~~~~~~~
  1913.          This sort arranges students by recent trend, highest to
  1914.     lowest, using the trend period you have set (or the default of
  1915.     3), and based on the test currently displayed at the top of the
  1916.     Test screen.  To use this sort effectively, do the following:
  1917.     
  1918.        a. Set the trend period you want with Alt-P.
  1919.     
  1920.        b. Zoom on the test (Alt-Z) you want at the end of the trend
  1921.           period, so that it appears on the Test screen.  Usually,
  1922.           this will be the most recent set of scores, but you can go
  1923.           as far back as you like.
  1924.     
  1925.        c. Press Alt-A for the Arrange menu and you'll see on the
  1926.           list (for example):
  1927.     
  1928.                      Trend: Test.2 - Quiz.5
  1929.     
  1930.           Select this item after making sure this is the trend
  1931.           period you wanted.  The selection will be unavailable if
  1932.           your trend period goes back further than there are scores
  1933.           for.
  1934.     
  1935.          When the sort is complete, all positive trends are display-
  1936.     ed on a green background, negative trends on a red background.
  1937.     You can do a 'print screen' (Prt Sc) at this time or press any
  1938.     other key to clear the trend indicators.  From these indicators,
  1939.     you can quickly identify students who are beginning to 'lose
  1940.     it', or those who have dramatically improved.  You may also wish
  1941.     to graph certain students (Alt-G) for a more detailed view of
  1942.     their performance.
  1943.     
  1944.     
  1945.     4. Class Stats
  1946.        ~~~~~~~~~~~
  1947.          The 'Class Stats' listing (Alt-C from Edit, Graph, or
  1948.     Report) now also gives the range of student averages (the high-
  1949.     est average minus the lowest average), as well as the class
  1950.     trend described above.
  1951.     
  1952.     
  1953.     5. Grading On The Curve
  1954.        ~~~~~~~~~~~~~~~~~~~~
  1955.          After selecting a new standard deviation and average, you
  1956.     may wish to look at the adjusted data (test averages or over-all
  1957.     averages depending on whether you graphed a test or the class).
  1958.     
  1959.     
  1960.                                 - 31 -
  1961.     
  1962.     
  1963.     
  1964.     Adjusted averages that are higher than the original averages are
  1965.     now displayed on a green background, those that are lower on a
  1966.     red background.  This gives a highly visual indication of how
  1967.     the class is affected by the experimental settings.  You may
  1968.     then want to go back and try different settings.
  1969.     
  1970.                        ________________________
  1971.     
  1972.     
  1973.     
  1974.     Version 1.3, September 1, 1990
  1975.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1976.     Correlation Coefficient
  1977.     ~~~~~~~~~~~~~~~~~~~~~~~
  1978.          When you graph a test in version 1.3, the statistical data
  1979.     now includes the correlation coefficient for those test results
  1980.     versus student averages before the test (abbreviated as
  1981.     'C.Coeff').  The Pearson product-moment correlation coefficient
  1982.     is a unitless index telling you how close a relationship exists
  1983.     between students' averages before the test was given and their
  1984.     marks on the test you have selected to graph.  The statistic
  1985.     only becomes available after the fourth test has been entered,
  1986.     so that student averages have had time to stabilize.
  1987.     
  1988.          Normally, one would expect a positive linear relationship
  1989.     between past performance and future performance.  That is, stu-
  1990.     dents with high averages will tend to score high on the next
  1991.     test and those with low averages to score low.  So this statis-
  1992.     tical index answers the question: How close are these test re-
  1993.     sults to the results you would have predicted, based on past
  1994.     performance?  Another way to put it is: How consistent are these
  1995.     test results with results obtained previously?  Did students on
  1996.     the whole, perform typically on this test compared with previous
  1997.     tests?
  1998.     
  1999.          In statistical work, a correlation coefficient of +0.7 or
  2000.     higher indicates a strong linear relationship.  Such a rela-
  2001.     tionship is typically found between height and weight, or be-
  2002.     tween those having blonde hair and blue eyes.  A coefficient
  2003.     less than +0.3 indicates a very weak relationship, the kind of
  2004.     relationship you might find were you to compare students' grades
  2005.     in Math with those in Art.  A coefficient of 1.0 indicates an
  2006.     exact correlation.  An exact correlation doesn't necessarily
  2007.     mean that each student's test score is exactly the same as his
  2008.     average, only that there is perfect consistency.  In other
  2009.     words, if the test was more difficult than previous tests, a
  2010.     coefficient of 1.0 shows that each student scored lower than
  2011.     usual by the same amount.
  2012.     
  2013.          A correlation coefficient of zero indicates that there is
  2014.     no linear relationship whatsoever.  Such a relationship might be
  2015.     found between shoe size and preference for Coke or Pepsi.  A
  2016.     coefficient less than zero (to as low as -1.0) indicates an in-
  2017.     verse linear relationship.  In Making The Grade, a negative co-
  2018.     efficient would result if high-average students did poorly on a
  2019.     particular test, and low-average students did well on that test.
  2020.     
  2021.     
  2022.     
  2023.     
  2024.                                 - 32 -
  2025.     
  2026.     
  2027.     
  2028.     What Are The Implications?
  2029.     ~~~~~~~~~~~~~~~~~~~~~~~~~~
  2030.          A low correlation coefficient (less than 0.3) should alert
  2031.     you to the fact that for whatever reason, this test did not
  2032.     produce typical results.  Students may express surprise, some
  2033.     claiming they did much better then they expected, and some worse
  2034.     then they expected.  Remember that if everyone performed worse
  2035.     than usual, or everyone better than usual, the strong linear re-
  2036.     lationship is maintained; a low coefficient indicates unexpected
  2037.     or scattered results.
  2038.     
  2039.          By studying the responses to individual questions on the
  2040.     test, you may discover that certain questions are worded am-
  2041.     biguously.  Students have interpreted the questions in a number
  2042.     of ways, each believing he is answering the question correctly.
  2043.     Or perhaps the test has many multiple choice questions and
  2044.     everyone did a lot of guessing.  The test is certainly suspect
  2045.     if you give the same test to different classes, or in different
  2046.     semesters, and get similar correl- ation coefficients.  You may
  2047.     want to change or eliminate some questions.
  2048.     
  2049.          Another possibility is that a particular group in the
  2050.     class, independent of scholastic ability, scored poorly on cer-
  2051.     tain test items.  For example, several students who happen to be
  2052.     in the school band, or are on the football team, all missed a
  2053.     class in which an important topic was covered.  This may account
  2054.     for the discrepant test results.
  2055.     
  2056.          To minimize the effect of an atypical set of test scores,
  2057.     you can either lower the test weight so it is worth less, or
  2058.     even eliminate the test by setting its weight to zero.  Alter-
  2059.     nately, you may wish to experiment with 'grading on the curve'
  2060.     (press ESC from the Test graph screen) to try and 'smooth out
  2061.     the wrinkles'.  (Actually, this has only a small effect on the
  2062.     correlation coefficient).
  2063.     
  2064.          In conclusion, the underlying assumption throughout this
  2065.     discussion has been that students perform in a predictable fash-
  2066.     ion, and that results from tests administered over a long period
  2067.     of time should reflect this assumption.  The correlation coef-
  2068.     ficient therefore, either confirms that everything is pretty
  2069.     much as you expected, or signals to you that something may be
  2070.     amiss.  A more thorough mathematical treatment of correlation
  2071.     coefficients (and the closely related linear regression) can be
  2072.     found in any first year university statistics or psychology
  2073.     textbook.
  2074.                       ________________________
  2075.     
  2076.     
  2077.     Version 1.4, October 6, 1990
  2078.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2079.     
  2080.          When editing a cell, you can now press one of the four
  2081.     arrow (cursor) keys when finished, instead of pressing RETURN.
  2082.     Pressing a cursor key completes the entry, and then moves the
  2083.     spreadsheet cursor in the direction indicated by the cursor key.
  2084.     
  2085.                       ________________________
  2086.     
  2087.                                 - 33 -
  2088.     
  2089.     
  2090.     
  2091.     Version 1.5, February 24, 1991
  2092.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2093.  
  2094.          Under DOS 4.1, MTG 1.4 incorrectly reported the amount of
  2095.     free space on the data disk as 0 K.  This has been fixed in
  2096.     version 1.5.
  2097.          As well, version 1.5 comes with an installation program
  2098.     to make copying the program files to your hard drive a little
  2099.     easier.  Insert the MTG program disk in a floppy drive (A: or
  2100.     B:) and log on by typing A: (or B:).  Then type INSTALL and
  2101.     follow the directions on screen.
  2102.  
  2103.  
  2104.     
  2105.     Version 2.0, March 22, 1991
  2106.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2107.  
  2108.          All file I/O routines have been re-written for greater
  2109.     speed.  Loading files from a hard drive is about 9 x faster
  2110.     then previous versions.  To accomplish this, the file struc-
  2111.     ture has been changed and version 2.0 cannot read files in
  2112.     the old format (1.5 or earlier).  A utility named CONVERT is
  2113.     included with the registered version to help you convert old
  2114.     files to the new format.
  2115.  
  2116.          You may now use a `total marks' scheme rather than assign
  2117.     a weight to each test.  Using this method is extremely simple:
  2118.     just don't enter any test weights!  If you enter even a single
  2119.     test weight, MTG reverts to the weighting method.  When using
  2120.     `total marks', the `TotWgt' heading reads `TotMks' -- this in
  2121.     fact is the default when you begin a new file.  IMPORTANT: You
  2122.     can't mix the two methods within a file so you should decide
  2123.     which method you want to use at the start of a semester.
  2124.     Switching from one system to the other in mid-semester would
  2125.     almost certainly affect student averages.
  2126.  
  2127.  
  2128.     The Legal Stuff
  2129.     ~~~~~~~~~~~~~~~
  2130.          While every precaution has been taken to ensure the
  2131.     correctness of the software and its accompanying manual,  Coffee
  2132.     Mug Software cannot assume any responsibility or liability for
  2133.     any damage or loss caused by the software.  Coffee Mug Software
  2134.     reserves the right to make changes and improvements to the
  2135.     manual and software at any time without notice.  It is the
  2136.     responsibility of the user to make the necessary back-ups for
  2137.     his/her data and program diskette.
  2138.     
  2139.     
  2140.     About The Author
  2141.     ~~~~~~~~~~~~~~~~
  2142.          I am a high school teacher in the Frontenac County Board of
  2143.     Education in southern Ontario, Canada.  Currently, I'm attempt-
  2144.     ing to break away from teaching and make a living by writing
  2145.     educational software on a full-time basis.
  2146.                        ______________________
  2147.     
  2148.     
  2149.                                 - 34 -
  2150.